package com.example.a_java.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.a_java.entity.RepaymentInstallment;

import java.math.BigDecimal;
import java.time.LocalDate;
import java.util.List;
import java.util.Map;

/**
 * 还款分期明细Service接口
 */
public interface RepaymentInstallmentService extends IService<RepaymentInstallment> {

    /**
     * 根据还款计划ID查询分期明细列表
     *
     * @param planId 还款计划ID
     * @return 分期明细列表
     */
    List<RepaymentInstallment> getInstallmentsByPlanId(Long planId);

    /**
     * 更新分期明细的还款信息
     *
     * @param id        分期明细ID
     * @param payDate   还款日期
     * @param payAmount 还款金额
     * @return 是否更新成功
     */
    boolean updatePaymentInfo(Long id, LocalDate payDate, BigDecimal payAmount);

    /**
     * 更新分期明细的逾期信息
     *
     * @param id          分期明细ID
     * @param overdueDays 逾期天数
     * @param penalty     罚息
     * @return 是否更新成功
     */
    boolean updateOverdueInfo(Long id, Integer overdueDays, BigDecimal penalty);

    /**
     * 批量生成分期明细
     *
     * @param planId          计划ID
     * @param loanAmount      贷款金额
     * @param interestRate    年利率
     * @param totalPeriods    总期数
     * @param repaymentMethod 还款方式
     * @param startDate       开始日期
     * @return 是否生成成功
     */
    boolean generateInstallments(Long planId, BigDecimal loanAmount, BigDecimal interestRate,
                              Integer totalPeriods, String repaymentMethod, LocalDate startDate);

    /**
     * 处理分期明细逾期
     * 
     * @param installmentId 分期明细ID
     * @return 是否处理成功
     */
    boolean processOverdue(Long installmentId);

    /**
     * 计算罚息金额
     * 
     * @param installmentId 分期明细ID
     * @param overdueDays 逾期天数
     * @return 包含罚息计算结果的Map
     */
    Map<String, Object> calculatePenalty(Long installmentId, Integer overdueDays);
} 